v5.0.0

Compare Source

• New Violations: Component names now need to start with an uppercase letter instead of a non-lowercase letter. This means _Button or _component are no longer valid. (@​kassens) in #​25162

• Consider dispatch from useActionState stable. (@​eps1lon in #​29665)
• Add support for ESLint v9. (@​eps1lon in #​28773)
• Accept as expression in callback. (@​StyleShit in #​28202)
• Accept as expressions in deps array. (@​StyleShit in #​28189)
• Treat React.use() the same as use(). (@​kassens in #​27769)
• Move use() lint to non-experimental. (@​kassens in #​27768)
• Support Flow as expressions. (@​cpojer in #​27590)
• Allow useEffect(fn, undefined). (@​kassens in #​27525)
• Disallow hooks in async functions. (@​acdlite in #​27045)
• Rename experimental useEvent to useEffectEvent. (@​sebmarkbage in #​25881)
• Lint for presence of useEvent functions in dependency lists. (@​poteto in #​25512)
• Check useEvent references instead. (@​poteto in #​25319)
• Update RulesOfHooks with useEvent rules. (@​poteto in #​25285)

v18.3.1

Compare Source

v18.3.0

Compare Source

v18.2.0

Compare Source

React DOM

• Provide a component stack as a second argument to onRecoverableError. (@​gnoff in #​24591)
• Fix hydrating into document causing a blank page on mismatch. (@​gnoff in #​24523)
• Fix false positive hydration errors with Suspense. (@​gnoff in #​24480 and @​acdlite in #​24532)
• Fix ignored setState in Safari when adding an iframe. (@​gaearon in #​24459)

React DOM Server

• Pass information about server errors to the client. (@​salazarm and @​gnoff in #​24551 and #​24591)
• Allow to provide a reason when aborting the HTML stream. (@​gnoff in #​24680)
• Eliminate extraneous text separators in the HTML where possible. (@​gnoff in #​24630)
• Disallow complex children inside <title> elements to match the browser constraints. (@​gnoff in #​24679)
• Fix buffering in some worker environments by explicitly setting highWaterMark to 0. (@​jplhomer in #​24641)

Server Components (Experimental)

• Add support for useId() inside Server Components. (@​gnoff in #​24172)

v18.1.0

Compare Source

React DOM

• Fix the false positive warning about react-dom/client when using UMD bundle. (@​alireza-molaee in #​24274)
• Fix suppressHydrationWarning to work in production too. (@​gaearon in #​24271)
• Fix componentWillUnmount firing twice inside of Suspense. (@​acdlite in #​24308)
• Fix some transition updates being ignored. (@​acdlite in #​24353)
• Fix useDeferredValue causing an infinite loop when passed an unmemoized value. (@​acdlite in #​24247)
• Fix throttling of revealing Suspense fallbacks. (@​sunderls in #​24253)
• Fix an inconsistency in whether the props object is the same between renders. (@​Andarist and @​acdlite in #​24421)
• Fix a missing warning about a setState loop in useEffect. (@​gaearon in #​24298)
• Fix a spurious hydration error. (@​gnoff in #​24404)
• Warn when calling setState in useInsertionEffect. (@​gaearon in #​24295)
• Ensure the reason for hydration errors is always displayed. (@​gaearon in #​24276)

React DOM Server

• Fix escaping for the bootstrapScriptContent contents. (@​gnoff in #​24385)
• Significantly improve performance of renderToPipeableStream. (@​gnoff in #​24291)

ESLint Plugin: React Hooks

• Fix false positive errors with a large number of branches. (@​scyron6 in #​24287)
• Don't consider a known dependency stable when the variable is reassigned. (@​afzalsayed96 in #​24343)

Use Subscription

• Replace the implementation with the use-sync-external-store shim. (@​gaearon in #​24289)

v18.0.0

Compare Source

Below is a list of all new features, APIs, deprecations, and breaking changes.
Read React 18 release post and React 18 upgrade guide for more information.

New Features

React

• useId is a new hook for generating unique IDs on both the client and server, while avoiding hydration mismatches. It is primarily useful for component libraries integrating with accessibility APIs that require unique IDs. This solves an issue that already exists in React 17 and below, but it’s even more important in React 18 because of how the new streaming server renderer delivers HTML out-of-order.
• startTransition and useTransition let you mark some state updates as not urgent. Other state updates are considered urgent by default. React will allow urgent state updates (for example, updating a text input) to interrupt non-urgent state updates (for example, rendering a list of search results).
• useDeferredValue lets you defer re-rendering a non-urgent part of the tree. It is similar to debouncing, but has a few advantages compared to it. There is no fixed time delay, so React will attempt the deferred render right after the first render is reflected on the screen. The deferred render is interruptible and doesn't block user input.
• useSyncExternalStore is a new hook that allows external stores to support concurrent reads by forcing updates to the store to be synchronous. It removes the need for useEffect when implementing subscriptions to external data sources, and is recommended for any library that integrates with state external to React.
• useInsertionEffect is a new hook that allows CSS-in-JS libraries to address performance issues of injecting styles in render. Unless you’ve already built a CSS-in-JS library we don’t expect you to ever use this. This hook will run after the DOM is mutated, but before layout effects read the new layout. This solves an issue that already exists in React 17 and below, but is even more important in React 18 because React yields to the browser during concurrent rendering, giving it a chance to recalculate layout.

React DOM Client

These new APIs are now exported from react-dom/client:

• createRoot: New method to create a root to render or unmount. Use it instead of ReactDOM.render. New features in React 18 don't work without it.
• hydrateRoot: New method to hydrate a server rendered application. Use it instead of ReactDOM.hydrate in conjunction with the new React DOM Server APIs. New features in React 18 don't work without it.

Both createRoot and hydrateRoot accept a new option called onRecoverableError in case you want to be notified when React recovers from errors during rendering or hydration for logging. By default, React will use reportError, or console.error in the older browsers.

React DOM Server

These new APIs are now exported from react-dom/server and have full support for streaming Suspense on the server:

• renderToPipeableStream: for streaming in Node environments.
• renderToReadableStream: for modern edge runtime environments, such as Deno and Cloudflare workers.

The existing renderToString method keeps working but is discouraged.

v18.3.1

Compare Source

v18.3.0

Compare Source

v18.2.0

Compare Source

React DOM

• Provide a component stack as a second argument to onRecoverableError. (@​gnoff in #​24591)
• Fix hydrating into document causing a blank page on mismatch. (@​gnoff in #​24523)
• Fix false positive hydration errors with Suspense. (@​gnoff in #​24480 and @​acdlite in #​24532)
• Fix ignored setState in Safari when adding an iframe. (@​gaearon in #​24459)

React DOM Server

• Pass information about server errors to the client. (@​salazarm and @​gnoff in #​24551 and #​24591)
• Allow to provide a reason when aborting the HTML stream. (@​gnoff in #​24680)
• Eliminate extraneous text separators in the HTML where possible. (@​gnoff in #​24630)
• Disallow complex children inside <title> elements to match the browser constraints. (@​gnoff in #​24679)
• Fix buffering in some worker environments by explicitly setting highWaterMark to 0. (@​jplhomer in #​24641)

Server Components (Experimental)

• Add support for useId() inside Server Components. (@​gnoff in #​24172)

v18.1.0

Compare Source

React DOM

• Fix the false positive warning about react-dom/client when using UMD bundle. (@​alireza-molaee in #​24274)
• Fix suppressHydrationWarning to work in production too. (@​gaearon in #​24271)
• Fix componentWillUnmount firing twice inside of Suspense. (@​acdlite in #​24308)
• Fix some transition updates being ignored. (@​acdlite in #​24353)
• Fix useDeferredValue causing an infinite loop when passed an unmemoized value. (@​acdlite in #​24247)
• Fix throttling of revealing Suspense fallbacks. (@​sunderls in #​24253)
• Fix an inconsistency in whether the props object is the same between renders. (@​Andarist and @​acdlite in #​24421)
• Fix a missing warning about a setState loop in useEffect. (@​gaearon in #​24298)
• Fix a spurious hydration error. (@​gnoff in #​24404)
• Warn when calling setState in useInsertionEffect. (@​gaearon in #​24295)
• Ensure the reason for hydration errors is always displayed. (@​gaearon in #​24276)

React DOM Server

• Fix escaping for the bootstrapScriptContent contents. (@​gnoff in #​24385)
• Significantly improve performance of renderToPipeableStream. (@​gnoff in #​24291)

ESLint Plugin: React Hooks

• Fix false positive errors with a large number of branches. (@​scyron6 in #​24287)
• Don't consider a known dependency stable when the variable is reassigned. (@​afzalsayed96 in #​24343)

Use Subscription

• Replace the implementation with the use-sync-external-store shim. (@​gaearon in #​24289)

v18.0.0

Compare Source

Below is a list of all new features, APIs, deprecations, and breaking changes.
Read React 18 release post and React 18 upgrade guide for more information.

New Features

React

• useId is a new hook for generating unique IDs on both the client and server, while avoiding hydration mismatches. It is primarily useful for component libraries integrating with accessibility APIs that require unique IDs. This solves an issue that already exists in React 17 and below, but it’s even more important in React 18 because of how the new streaming server renderer delivers HTML out-of-order.
• startTransition and useTransition let you mark some state updates as not urgent. Other state updates are considered urgent by default. React will allow urgent state updates (for example, updating a text input) to interrupt non-urgent state updates (for example, rendering a list of search results).
• useDeferredValue lets you defer re-rendering a non-urgent part of the tree. It is similar to debouncing, but has a few advantages compared to it. There is no fixed time delay, so React will attempt the deferred render right after the first render is reflected on the screen. The deferred render is interruptible and doesn't block user input.
• useSyncExternalStore is a new hook that allows external stores to support concurrent reads by forcing updates to the store to be synchronous. It removes the need for useEffect when implementing subscriptions to external data sources, and is recommended for any library that integrates with state external to React.
• useInsertionEffect is a new hook that allows CSS-in-JS libraries to address performance issues of injecting styles in render. Unless you’ve already built a CSS-in-JS library we don’t expect you to ever use this. This hook will run after the DOM is mutated, but before layout effects read the new layout. This solves an issue that already exists in React 17 and below, but is even more important in React 18 because React yields to the browser during concurrent rendering, giving it a chance to recalculate layout.

React DOM Client

These new APIs are now exported from react-dom/client:

• createRoot: New method to create a root to render or unmount. Use it instead of ReactDOM.render. New features in React 18 don't work without it.
• hydrateRoot: New method to hydrate a server rendered application. Use it instead of ReactDOM.hydrate in conjunction with the new React DOM Server APIs. New features in React 18 don't work without it.

Both createRoot and hydrateRoot accept a new option called onRecoverableError in case you want to be notified when React recovers from errors during rendering or hydration for logging. By default, React will use reportError, or console.error in the older browsers.

React DOM Server

These new APIs are now exported from react-dom/server and have full support for streaming Suspense on the server:

• renderToPipeableStream: for streaming in Node environments.
• renderToReadableStream: for modern edge runtime environments, such as Deno and Cloudflare workers.

The existing renderToString method keeps working but is discouraged.